home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / XmStringByteCompare.z / XmStringByteCompare
Encoding:
Text File  |  2003-11-18  |  2.7 KB  |  67 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSttttrrrriiiinnnnggggBBBByyyytttteeeeCCCCoooommmmppppaaaarrrreeee((((3333XXXX))))   UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV   XXXXmmmmSSSSttttrrrriiiinnnnggggBBBByyyytttteeeeCCCCoooommmmppppaaaarrrreeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       _X_m_S_t_r_i_n_g_B_y_t_e_C_o_m_p_a_r_e -    A compound string function that
  10.       indicates the    results    of a byte-by-byte comparison
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       #include <Xm/Xm.h>
  14.  
  15.       Boolean XmStringByteCompare (ssss1111,,,, ssss2222)
  16.            _X_m_S_t_r_i_n_g     ssss1111;
  17.            _X_m_S_t_r_i_n_g     ssss2222;
  18.  
  19.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.       _X_m_S_t_r_i_n_g_B_y_t_e_C_o_m_p_a_r_e returns a    Boolean    indicating the results
  21.       of a byte-by-byte comparison of two compound strings.
  22.  
  23.       In general, if two compound strings are created with the
  24.       same (char *)    string using _X_m_S_t_r_i_n_g_C_r_e_a_t_e_L_o_c_a_l_i_z_e_d in    the
  25.       same language    environment, the compound strings compare as
  26.       equal.  If two compound strings are created with the same
  27.       (char    *) string and the same font list element tag set other
  28.       than _X_m_F_O_N_T_L_I_S_T__D_E_F_A_U_L_T__T_A_G using _X_m_S_t_r_i_n_g_C_r_e_a_t_e, the
  29.       strings compare as equal.
  30.  
  31.       In some cases, once a    compound string    is put into a widget,
  32.       that string is converted into    an internal form to allow
  33.       faster processing.  Part of the conversion process strips
  34.       out unnecessary or redundant information.  If    an application
  35.       then does an _X_t_G_e_t_V_a_l_u_e_s to retrieve a compound string from
  36.       a widget (specifically, Label    and all    of its subclasses), it
  37.       is not guaranteed that the compound string returned is
  38.       byte-for-byte    the same as the    string given to    the widget
  39.       originally.
  40.  
  41.       ssss1111   Specifies a compound string to be compared with ssss2222
  42.  
  43.       ssss2222   Specifies a compound string to be compared with ssss1111
  44.  
  45.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  46.       Returns True if two compound strings are identical byte-by-
  47.       byte.
  48.  
  49.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  50.       _X_m_S_t_r_i_n_g_C_r_e_a_t_e(_3_X) and _X_m_S_t_r_i_n_g_C_r_e_a_t_e_L_o_c_a_l_i_z_e_d(_3_X).
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/11/03)
  64.  
  65.  
  66.  
  67.